Skip to content

Chore/docs and housekeeping - #169

Merged
bitbacchus merged 2 commits into
mainfrom
chore/docs-and-housekeeping
Aug 19, 2026
Merged

Chore/docs and housekeeping#169
bitbacchus merged 2 commits into
mainfrom
chore/docs-and-housekeeping

Conversation

@bitbacchus

Copy link
Copy Markdown
Member

Housekeeping for the docs and a dead npm script.

docs: refresh README, add Caddy install guide

The README's Setup section was stale and had a broken link:

  • lerna bootstrap was removed in Lerna v7 (repo runs 8.x)
  • The [Installation Guide](INSTALLATION.de.md) link was dead
  • The frontend .env instruction no longer matched how config is loaded.

Changes:

  • Replaced the Setup section with a Documentation section linking the
    published User Guide and the new
    installation guide.
  • Added INSTALLATION.md — a general, self-hosting guide for the single-server
    Docker Compose + Caddy setup: prerequisites,
    DNS/firewall, .env.production, OIDC callback registration, deploy/verify/update,
    backups, and appendices for data migration and the Docker-MTU-on-overlay caveat.
    Documents deployment.sh's assumptions (passwordless sudo, fixed
    .env.production filename, default production branch, hard-reset behaviour).
  • Translate the funding-section heading to English and add an English gloss;
    the German acknowledgment text is kept verbatim.

chore: remove dead lerna bootstrap npm script

"bootstrap": "lerna bootstrap" errors under Lerna 8, is referenced nowhere
(CI, deployment.sh, docs), and is redundant — npm workspaces link the packages
on npm install / npm ci. Removed. Lerna stays (still used as lerna run …).

- Remove the outdated Setup section from the README (lerna bootstrap was
  removed in Lerna v7; stale frontend .env instruction) and replace the dead
  INSTALLATION.de.md link (deleted in the Caddy migration) with a
  Documentation section linking the published User Guide and the new guide.
- Translate the funding section heading and add an English gloss; keep the
  German acknowledgment verbatim.
- Add INSTALLATION.md: a general self-hosting guide for the single-server
  Docker Compose + Caddy setup (not tied to any specific cloud), including the
  deployment.sh assumptions (passwordless sudo, fixed .env.production filename,
  default branch, hard-reset caveat).
lerna bootstrap was removed in Lerna v7 (repo runs 8.x) and now errors.
npm workspaces already link packages on npm install/npm ci, so the script
had no purpose and was referenced nowhere (CI, deployment.sh, docs).
@bitbacchus
bitbacchus merged commit 26c0063 into main Aug 19, 2026
5 checks passed
@codecov

codecov Bot commented Aug 19, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@bitbacchus
bitbacchus deleted the chore/docs-and-housekeeping branch August 19, 2026 15:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant